Transferência Pix com Chave

Para realizar um PIX com uma chave, é necessário _primeiramente _realizar a consulta das informações da chave a através do endpoint de inicialização de pagamento e por fim a efetivação da transferência.

Inicialização de pagamento

Este endpoint vai te fornecer dados básicos relativos à chave consultada, Além disso, ele fornecerá o atributo "endToEndId" que será cobrado pelo endpoint de transferência se você optar pelo Pix com Chave.

Info

No ambiente de homologação, você só poderá fazer transferências para chaves que existam no ambiente de homologação.

Pix Keys examples

Observe que uma transferência Pix não pode ser feita de uma conta para ela mesma.

Conta Beneficiária	Chave	Tipo
31712	+5511999975734	PHONE
31712	[email protected]	EMAIL
31712	1aa5ef56-3b5f-4665-9ece-e7513efc03e5	EVP
29823	30287697789	DOCUMENT
29823	0a192461-051f-438b-b9c4-2db423039281	EVP
29823	30287697789	DOCUMENT
30422	06790157000144	DOCUMENT
30422	255d38b2-42c1-4593-844d-8e92bd6cb438	EVP
30422	790aa11-8199-40f5-bfad-6ab99a73ab3a	EVP

Segue abaixo o exemplo de request e response. Para mais detalhes do endpoint, click here.

Requisição

URL

POST 'https://apisandbox.delbank.com.br/baas/api/v2/pix/dict/payment-initialization'

cURL

curl --location 'https://apisandbox.delbank.com.br/baas/api/v2/pix/dict/payment-initialization' \
--header 'x-delbank-api-key: {{apiKey}}' \
--header 'x-delfinance-account-id: {{accountId}}'
--header 'Content-Type: application/json' \
--data '{
    "key": "+5511999975734"
}'

Headers

Nome	Descrição
x-delbank-api-key	Obrigatório. Chave de API
x-delfinance-account-id	Obrigatório. O número da conta Delfinance.

Corpo da requisição

Nome	Type	Descrição
key	string	Obrigatório. Chave PIX registrada no DICT
holderDocument	string	Opcional Documento do titular para verificar se ele é o dono da chave que está sendo pesquisada. Se este campo for fornecido, a resposta de pesquisa da chave Pix retornará um FLAG indicando (keyBelongsHolder) se a chave pertence a este titular.

Resposta

O status code 200 indicará sucesso na transação.

Sendo bem-sucedido, o retorno irá trazer os seguintes campos em formato JSON:

Note

🚧 Utilizar o atributo endToEndId na requisição de transferência.

{
    "endToEndId": "E38224857202412201244TP05NXG36QK",
    "key": "30287697789",
    "beneficiary": {
        "number": "29823",
        "branch": "1",
        "type": "CURRENT",
        "participant": {
            "name": "DELCRED SCD S.A.",
            "ispb": "38224857"
        },
        "holder": {
            "name": "HOMOLOGACAO INTEGRACAO API",
            "document": "***876977**",
            "type": "NATURAL"
        }
    },
    "keyBelongsHolder": false
}

Caso seja passado holderDocument correto, a response será assim:

{
    "endToEndId": "E3822485720241220122418yWF7jWUKA",
    "key": "30287697789",
    "beneficiary": {
        "number": "29823",
        "branch": "1",
        "type": "CURRENT",
        "participant": {
            "name": "DELCRED SCD S.A.",
            "ispb": "38224857"
        },
        "holder": {
            "name": "HOMOLOGACAO INTEGRACAO API",
            "document": "***876977**",
            "type": "NATURAL"
        }
    },
    "keyBelongsHolder": true
}

Efetivação da transferência

Após realizar a inicialização de pagamento, conferir as informações da conta beneficiária e está com posse da endToEndId retornada, deve executar a chamada do endpoint de transferência.

Requisição

URL

POST 'https://apisandbox.delbank.com.br/baas/api/v2/transfers

cURL

curl --request POST \
     --url https://apisandbox.delbank.com.br/baas/api/v2/transfers \
     --header 'IdempotencyKey: 9d16ea35-8a85-49ea-a41e-bcf56c677129' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --header 'x-delbank-api-key: {{apiKey}}' \
     --header 'x-delfinance-account-id: {{accountId}}' \
     --data '
{
    "amount": 0.01,
    "description": "description",
    "endToEndId": "E3822485720230814223254707809687",
    "initiationType": "KEY"
}
'

Headers

Nome	Descrição
x-delbank-api-key	Obrigatório. Chave de API
x-delfinance-account-id	Obrigatório. O número da conta Delfinance.
IdempotencyKey	Obrigatório. Chave idempotência da requisição. Informe um GUID, sendo um novo cada requisição.

Body

Nome	Tipo	Descrição
amount	number	Obrigatório. Valor da transferência
description	string	Descrição sobre a transferência. Essa informação será mostrada a conta beneficiária
endToEndId	string	Obrigatório. EndToEndId retornada na consulta da chave
initiationType	enum	Obrigatório. Tipo de inicialização. Utilizar o tipo 'KEY' para este caso

Resposta

O status code 200 indicará sucesso na transação.

Sendo bem-sucedido, o retorno irá trazer os seguintes campos em formato JSON:

🚧 Essas informações serão retornadas após a criação da transferência e consulta da transferência.

{
    "id": "0fc7821d-b488-4268-88c0-a2bc443d046e",
    "endToEndId": "E3822485720230808004731LMaDWkOcM",
    "transactionNsu": 722355,
    "status": "PIX_PROCESSING",
    "type": "PIX_KEY",
    "amount": 0.55,
    "createdAt": "2023-08-08T00:47:31.251Z",
    "description": "manual JD",
    "payer": {
        "number": "31712",
        "branch": "0001",
        "type": "CURRENT",
        "holder": {
            "document": "32752023000149",
            "name": "bxxdbde",
            "type": "LEGAL"
        },
        "participant": {
            "name": "DELBANK",
            "ispb": "38224857"
        }
    },
    "beneficiary": {
        "number": "46441",
        "branch": "0007",
        "type": "CURRENT",
        "holder": {
            "document": "01234567890",
            "name": "CICLANO FULANO",
            "type": "NATURAL"
        },
        "participant": {
            "name": "BANCO DA AMAZONIA S.A.",
            "ispb": "04902979"
        }
    }
}

Pix Status

Name	Description
PIX_ERROR	ocorreu um erro na transferência
PIX_PROCESSING	A transferência está sendo processada
PIX_WAITING_SPI_RESPONSE	A transferência está esperando uma resposta do SPI
PIX_EFFECTIVE	A transferência foi bem-sucedida
PIX_REFUND_PAYMENT_UPDATED	Evento para devoluções enviadas